spec-extractor: switch round-robin to git-based README version stamps#31813
Merged
Conversation
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Use git file version stamps for round-robin selection
spec-extractor: switch round-robin to git-based README version stamps
May 12, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
The PR description states it updates spec-extractor round-robin package selection to a stateless, git-stamp-based approach, but the actual code changes in this diff appear limited to formatting/whitespace adjustments and a regenerated workflow header.
Changes:
- Removed an extraneous blank line in a Go workflow test.
- Reformatted a dynamic import destructuring statement in a Vitest test.
- Updated the autogenerated metadata header (
compiler_version) inagentic_commands.yml.
Show a summary per file
| File | Description |
|---|---|
| pkg/workflow/shared_workflow_test.go | Removes an extra whitespace-only line in a test file. |
| actions/setup/js/assign_agent_helpers.test.cjs | Reflows an await import() destructuring assignment for readability. |
| .github/workflows/agentic_commands.yml | Updates the generated header comment (compiler_version). |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 3/3 changed files
- Comments generated: 1
| @@ -1,4 +1,4 @@ | |||
| # gh-aw-commands: {"payload_version":"v1","schema_version":"v1","compiler_version":"796aca5","commands":["ace","approach-validator","archie","brave","cloclo","craft","grumpy","mergefest","nit","plan","poem-bot","review","security-review","summarize","tidy","unbloat"],"workflows":["ace-editor","approach-validator","archie","brave","cloclo","craft","grumpy-reviewer","mergefest","pdf-summary","plan","poem-bot","pr-code-quality-reviewer","pr-nitpick-reviewer","security-review","tidy","unbloat-docs"]} | |||
| # gh-aw-commands: {"payload_version":"v1","schema_version":"v1","compiler_version":"b071b66","commands":["ace","approach-validator","archie","brave","cloclo","craft","grumpy","mergefest","nit","plan","poem-bot","review","security-review","summarize","tidy","unbloat"],"workflows":["ace-editor","approach-validator","archie","brave","cloclo","craft","grumpy-reviewer","mergefest","pdf-summary","plan","poem-bot","pr-code-quality-reviewer","pr-nitpick-reviewer","security-review","tidy","unbloat-docs"]} | |||
Collaborator
|
@copilot merge main and recompile |
…version-stamps # Conflicts: # .github/workflows/agentic_commands.yml Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Contributor
Author
Done. I merged |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
✨ Enhancement
The spec-extractor package selection logic now derives rotation order from git file history instead of cache-memory state. This makes selection stateless and reproducible, while ensuring packages without a README are prioritized first (
timestamp=0).What does this improve?
Stateless rotation
Selection order is computed from git version stamps forpkg/*/README.md, removing dependence on/tmp/gh-aw/cache-memory/spec-extractor/rotation.json.New package prioritization
Packages with no README commit history are assigned0and sorted first, so newly added packages are processed before previously stamped ones.Deterministic scheduling
Round-robin input order is stable from any checkout with the same git history; cache eviction/reset no longer affects selection behavior.Why is this valuable?
Implementation approach:
Pre-agent package selection rewrite
Replaced index-based cache rotation with git stamp collection + sort-based selection.Context contract update
Updated/tmp/pkg-context.mdmetadata fields to report git-stamp-derived selection state instead oflast_index.Prompt/guidance alignment
Updated workflow guidance text to reflect stateless git-stamp rotation semantics.